home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / jnos / cmdshelp / ifconfig < prev    next >
Text File  |  1994-08-09  |  9KB  |  220 lines
  1.  
  2. ifconfig [<subcommand>]
  3.  
  4.      If a valid subcommand is given, it will be executed (see below).
  5. When no subcommand is given, display a list of interfaces, with a
  6. short status for each.  See the 'ifconfig <iface>' command for a
  7. description of the display.
  8.  
  9.      ALL ax25 and MOST tcp parameters are now configurable per
  10. interface.  The 'ax25 <cmd>' commands set the system default values
  11. and the 'ifconfig <iface> ax25 <command>' commands set or show the
  12. interface specific value(s).  The 'tcp <cmd>' commands work in the
  13. same manner.
  14.  
  15.      As a result of this change, 'ifconfig' NO LONGER takes multiple
  16. commands on one line.  'ifconfig ln0 netmask ffffff00 broadcast
  17. 255.255.255.255' is invalid.  The command line must be separated into
  18. two commands as: 'ifconfig ln0 netmask ffffff00' and 'ifconfig ln0
  19. broadcast 255.255.255.255'
  20.  
  21.      
  22.  
  23.     ifconfig <iface> [<subcommands>]
  24.  
  25.      When only iface is given, the interface status is displayed.
  26.      
  27.      Interface status shows:
  28.      
  29.         IP addr - the ip address assigned to this interface
  30.         MTU     - the maximum transmission unit for this interface.
  31.         Link encap - the type of link protocol to send packets  with
  32.                   over this interface (AX.25, NETROM etc.)
  33.         Paclen  - if the interface is an AX.25 interface, this is the
  34.                   Paclen used for connections on this interface
  35.         flags   - interface flags, the sum of all the options set with
  36.                   the various commands. See below.
  37.  
  38.         netmask - the ip network mask. See elsewhere for a discussion.
  39.                   broadcast - the ip broadcast address on this interface. Used
  40.                   when doing arp, etc.
  41.         sent ip - the number of ip packets sent on the interface
  42.         sent tot- the total number of packets sent (i.e. ip, ax.25,
  43.                   etc.)
  44.         sent idle - the elapsed time this interface hasn't transmitted
  45.                   any data.
  46.         recv ip - the number of ip packets received on the interface
  47.         recv tot- the total number of packets received  (i.e. ip,
  48.                   ax.25, etc.)
  49.         recv idle- the elapsed time this interface hasn't received any
  50.                   data.
  51.         descr   - a description of the interface
  52.  
  53.      Interface flag values are the sums of the following options, and
  54.      can be set or unset (i.e. toggled) with the following commands
  55.      (See their individual descriptions for more)
  56.  
  57. command           value                  description of flag
  58. mode iface        DATAGRAM_MODE     0    /* Send datagrams in raw
  59.                                             link frames */
  60.                   CONNECT_MODE      1    /* Send datagrams in
  61.                                             connected mode */
  62. netrom interface  IS_NR_IFACE       2    /* Activated for netrom use */
  63.                   NR_VERBOSE        4    /* broadcast routes verbose */
  64. convers interface IS_CONV_IFACE     8    /* Activated for conference
  65.                                             call access */
  66. ax25 bport        AX25_BEACON       16   /* Broadcast AX.25 beacons */
  67. mbox hide         HIDE_PORT         64   /* Don't show port in mbox
  68.                                             'P' command */
  69. ax25 digi         AX25_DIGI         128  /* Allow digipeating */
  70. arp eaves         ARP_EAVESDROP     256  /* Listen to ARP replies */
  71. arp poll          ARP_KEEPALIVE     512  /* Keep arp entries alive
  72.                                             after time-out */
  73. ax25 hport        LOG_AXHEARD       1024 /* Do ax.25 heard logging on
  74.                                             this interface */
  75. ip hport          LOG_IPHEARD       2048 /* Do IP heard logging on this
  76.                                             interface */
  77.  
  78.  
  79.     ifconfig <iface> ax25 [<subcommand>]
  80.  
  81.      Sets the value for 'subcommand' per description in the ax25
  82.      commands.  'ifconfig <iface> ax25' by itself displays the
  83.      following list of parameters and their values:
  84.      
  85.           bctext
  86.           blimit
  87.           cdigi
  88.           irtt
  89.           maxframe
  90.           maxwait
  91.           paclen
  92.           pthresh
  93.           retry
  94.           timertype
  95.           t3
  96.           t4
  97.           version
  98.           window
  99.  
  100.     ifconfig <iface> broadcast <addr>
  101.  
  102.      Set the ip broadcast address of interface <iface> to <addr>.
  103.      
  104.  
  105.     ifconfig <iface> cdigi <call>
  106.  
  107.      Set the 'crossband digipeater only' callsign.  If this call is
  108.      set, digipeating works independently from the 'ax25 digipeat'
  109.      setting.  Connections cannot be made to the cdigi call!
  110.      
  111.     ifconfig <iface> description "descr"
  112.  
  113.      This command sets the interface description to the string
  114.      specified.  If no descr is supplied (i.e. ""), the current
  115.      description will be cleared.  The description is displayed with
  116.      the mailbox or nodeshell P command (if the interface wasn't
  117.      hidden from that display).  It is also shown in the ifconfig
  118.      command.
  119.      
  120.  
  121.     ifconfig <iface> encapsulation <mode>
  122.  
  123.      Sets the encapsulation for interface iface to slip or ax25. This
  124.      should never be needed, since it is automatically executed when
  125.      interfaces are attached.
  126.      
  127.  
  128.     ifconfig <iface> forward <iface-2>
  129.  
  130.      When a forward is defined, all output for interface <iface> is
  131.      redirected to <iface-2>.  To remove the forward, set <iface-2> to
  132.      <iface>.
  133.      
  134.  
  135.     ifconfig <iface> ipaddress <addr>
  136.  
  137.      Set the IP address to <addr> for this interface. Normally the ip
  138.      address is assigned from the system ip address when the interface
  139.      is first attached. However, it might be necessary to change it
  140.      when a system acts as a ip-gateway.
  141.      
  142.  
  143.     ifconfig <iface> linkaddress <linkaddr>
  144.      Set the hardware dependent address for this interface.  For AX.25
  145.      this is the callsign.  If you want to allow cross band
  146.      digipeating, give each port a different ax.25 call with this
  147.      command.
  148.      
  149.      
  150.     ifconfig <iface> mtu <num>
  151.  
  152.      Set the maximum transfer unit to <num> bytes.
  153.  
  154.      
  155.  
  156.     ifconfig <iface> netmask <address>
  157.  
  158.      Set the sub-net mask for this interface.  The <address> takes the
  159.      form of  an IP  address  with 1's in the network and subnet parts
  160.      of the address, and 0's in the host part of the address.  Sample:
  161.      ifconfig  ec0  netmask  0xffffff00 for  a  class  C  network  (24
  162.      bits).  This is related to the 'broadcast' subcommand.  See also
  163.      the 'route' command.
  164.      
  165.  
  166.     ifconfig <iface> paclen <num>
  167.  
  168.      Set the AX.25 paclen for this interface. This is useful if you
  169.      want to use a value different from the default as set with the
  170.      'ax25 paclen' command; e.g., if you have a port with an HF link,
  171.      you might want to set it to 128.  You can also set it to greater
  172.      than 256 if you have a high speed port.  (This command only works
  173.      for interfaces that can carry AX.25 connections, i.e., it is not
  174.      for SLIP interfaces, etc.)
  175.      
  176.      NOTE1:  The AX.25 V2 specification specifies a MAXIMUM of 256 for
  177.      paclen. If you have a paclen > 256, you may run into problems
  178.      when interfacing to other non-NOS systems (in particular G8BPQ-
  179.      based systems.)
  180.      
  181.      NOTE2:  The value of paclen influences NETROM behavior if the
  182.      interface is activated for netrom with the 'netrom interface'
  183.      command!  If the paclen for this interface is smaller than any
  184.      other (netrom active) paclen, the netrom mtu value will be set to
  185.      this paclen - 20 !  This is to assure that you will not get
  186.      fragmentation at the ax.25 level when trying to send large data
  187.      packets over netrom connections.  AX.25 V2.1 fragmentation is
  188.      presently handled only by NOS and derived code as far as is
  189.      known.  Other systems, such as TheNet, BPQ, MSYS,  etc., may not
  190.      include proper handling of V2.1 fragmentation.
  191.      
  192.      What the preceding means is, if you have a VHF port with paclen
  193.      256, and an Hf port with paclen 128, and BOTH are active with
  194.      netrom, the netrom mtu will be 108 !
  195.  
  196.  
  197.     ifconfig <iface> tcp [<command>]
  198.  
  199.      Sets or displays the 'tcp' command parameters for <iface>.
  200.      'ifconfig <iface> tcp' by itself displays the following list:
  201.      
  202.           irtt
  203.           maxwait
  204.           mss
  205.           retries
  206.           syndata
  207.           timertype
  208.           window
  209.           
  210.      OUTGOING tcp connections get the values for the interface on
  211.      which the initial sync packet ('connect request') is routed out.
  212.      INCOMING tcp connections get the values for the interface the
  213.      initial request arrives on.
  214.      
  215.      System default TCP parameters must be set PRIOR TO attaching
  216.      interfaces.  After attaching interfaces, use the 'ifconfig
  217.      <iface> tcp' commands to set the interface.
  218.      
  219.  
  220.